Genera 8.0 Reference Cards 



Notation Conventions 



The documentation uses a number of notation conventions — a kind of shorthand 
— to represent keys, Lisp objects, command names, and mouse commands in a 
simple way. To get the most out of the documentation, you should be familiar with 
these conventions. 



Modifier Key Conventions 

Modifier keys are designed to be held down while pressing other keys. They do not 
themselves transmit characters. A combined keystroke like METR-K is pronounced 
"meta x" and written as m-K. This notation means that you press the METR key and, 
while holding it down, press the K key. 

Modifier keys are abbreviated as follows: 

CONTROL c- 

METR n- 

SUPER s- 

HYPER h- 

SHIFT sh- 

SYMBOL sy- 

Modifier keys can be used in combination, as well as singly. For example, the nota- 
tion c-n-Y indicates that you should hold down both the CONTROL and the METR 
keys while pressing Y. 

Modifier keys can also be used, both singly and in combination, to modify mouse 
commands. For example, the notation sh-Left means hold down the SHIFT key 
while clicking Left on the mouse and c-n-Middle means hold down CONTROL and 
METR while clicking Middle. 

The keys with white lettering (like K or SELECT) all transmit characters. Combina- 
tions of these keys should be pressed in sequence, one after the other (for exam- 
ple, SELECT L). This notation means that you press the SELECT key, release it, and 
then press the L key. 

LOCRL is an exception to this rule. Despite its white lettering, you must hold it 
down while pressing another key, or it has no effect. For example, to brighten the 
image on your monitor, you would hold down LOCRL while pressing B. 
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Documentation Conventions 

This documentation uses the following notation conventions: 

Printed representation of Lisp objects in running text. 

keys on the Symbolics Keyboard. 

Space bar. 

Literal typein. 

Lisp code examples. 



cond, zhhostat 

RETURN, RBORT, c-F 

SPRCE 

login 

(make-symbol "foo") 



(function-name argl &optional arg2) 

Syntax description of the invocation of function-name. 



argl 

&optional 
Show File, Start 



Argument to the function function-name, usually ex- 
pressed as a word that reflects the type of argument 
(for example, string). 

Introduces optional argument(s). 

Command Processor command names and Front-end 
Processor (FEP) command names appear with the ini- 
tial letter of each word capitalized. 



m-H Insert File, Insert File (n-K) 

Extended command names in Zmacs, Zmail, and Sym- 
bolics Concordia appear with the m-K notation either 
preceding the command name, or following it in 
parentheses. Both versions mean press m-K and then 
type the command name. 



[Map Over] 

Left, Middle, Right 
sh -Right, c-n-Middle 



Menu items. Click Left to select a menu item, unless 
other operations are indicated. (See the section 
"Mouse Command Conventions".) 

Mouse clicks. 

Modified mouse clicks. For example, sh-Right means 
hold down the SHIFT key while clicking Right on the 
mouse, and c-n-Middle means hold down CONTROL and 
METR while clicking Middle. 
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Mouse Command Conventions 

The following conventions are used to represent mouse actions: 

1. Square brackets delimit a menu item. 

2. Slashes (/) separate the members of a compound mouse command. 

3. The standard clicking pattern is as follows: 

• For a single menu item, always click Left. For example, the following two 
commands are identical: 

[Previous] 
[Previous (L)] 

• For a compound command, always click Right on each menu item (to dis- 
play a submenu) except the last, where you click Left (to cause an action 
to be performed). For example, the following two compound commands are 
equivalent: 

[Map Over / Move / Hardcopy] 

[Map Over (R) / Move (R) / Hardcopy (L)] 

4. When a command does not follow the standard clicking order, the notation for 
the command shows explicitly which button to click. For example: 

[Map Over / Move (M)] 
[Previous (R)] 
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Zmacs 

Getting Help in Zmacs 

help COMMAND 

You can get several different kinds of help in Zmacs by first pressing the HELP 
key, then any of the following keys: 

R Displays documentation for all the commands whose name or 

the first line of whose documentation contains a string you 
supply. Try HELP R Register to see how this works. 

C Displays documentation for a command you supply. Try HELP C 

c-K c-S. 

D Displays documentation for an extended (m-K) command. Try 

HELP D Show Documentation. (You can also type HELP C m-X Show 
Documentation.) 

L Displays the last sixty keystrokes you typed. This can be useful 

if you're not sure what you've just done. 

U Offers to undo changes to the buffer. 

U Displays all the Zmacs variables whose names contain a sub- 

string you supply. Try point. 

W Finds out whether an extended command you supply is bound 

to a key. Try Save File. 

SPRCE Repeats the most recent HELP command. For example, if you 

use HELP D, then press HELP SPRCE, you are prompted for the 
name of another extended command. 
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HELP WITH EXTENDED COMMANDS 

Extended commands (the m-K commands) put you in a small area of the screen 
with full editing capabilities (a minibuffer) for entering names and arguments. Sev- 
eral kinds of help are available in a minibuffer. 

COMPLETE Completes as much of the current command as possible. 

HELP Gives information about special characters and possible com- 

pletions. 

c-? Shows commands that start with the characters you have typed. 

END or RETURN Completes the command, and then executes it. 

c-/ Lists extended commands containing the strings you've typed 

so far. 

Mouse-Right Gives you a menu of completions for the command you are en- 

tering. Click Left on a completion in the menu to select it. 

See the section "Zmacs Completion". 



Zmacs Commands for Regions, Buffers, Screens, and Windows 
Region Operations 

c-SPRCE Sets the mark, a delimiter of a region. You move the cursor from 

mark to create a region; Zmacs marks (underlines) the region. 

Use with region commands such as c-W, n-W, c-Y, and m-K Format 

Region. 
c-W Kills region (c-Y yanks it back at point). 

n-W Copies the region into kill history (c-Y yanks it back at point). 

c-Y Yanks back the last thing killed. 

c-K c-J Changes the character style of a region to one that you specify. 

c-K c-L Lowercases the region. 

c-K c-U Uppercases the region. 

c-n-N Indents each line in the region; for example, c-0 c-m-\ indents 

each line to the left margin. 
c-sh-C Compiles the region. 

c-sh-E Evaluates the region. 

n-H Write Region 

Writes the region to a file you specify. 

Buffer Operations 

c-K c-F Reads a file into a buffer for editing. 

c-K B Selects a different buffer you specify; default is the last one. 

c-K c-B Displays a menu of available buffers; lines are mouse-sensitive. 

c-K K Kills a buffer you specify; default is the current one. 

n-< Moves to the beginning of the current buffer. 

n-> Moves to the end of the current buffer. 

c-n-L Selects the most recently selected buffer in this window (toggles 
between two buffers). 
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Screen Operations 

SCROLL or c-U Shows next screen. 

n-SCROLL or n-U Shows previous screen. 

c-0 c-L Moves the line where point is to line (top) of the screen. 

c-n-R Repositions the window to display all of the current definition, if 

possible. 
c-SCROLL Exposes and scroll the typeout window forward one screenful. 

c-n-SCROLL Exposes and scroll the typeout window back one screenful. 

n-H Split ScreenMakes several windows split among the buffers as specified. 

Window Operations 

c-K 2 Splits the screen in two windows, using the current buffer and 

the previously selected buffer (the one that c-m-L would select). 

c-K 1 Resumes single window display, using the current window. 

c-H Moves cursor to other window. 

c-n-U Shows next screen of the buffer in the other window; with a nu- 

meric argument scrolls that number of lines — positive for for- 
ward, negative for backward. 

c-K 4 Splits the screen into two windows and asks what should be 

shown in the other window. 

c-K ~ Changes the size of the current window by the number of lines 

you indicate with a numeric argument. A positive numeric argu- 
ment expands the window, a negative argument shrinks it. 

c-K 8 Splits the screen into two windows, showing the current region in 

the top window. 

n-H Compare Windows 

Compares two windows of a split screen, starting at current point 
in each, stopping at first difference between them, moving point 
in each window to that difference. 
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Other Useful Zmacs Commands 
Commands for Yanking and Undoing 

n-H Undo Returns the buffer to its state before the last command, querying 

first. You can also invoke it by pressing c-n-? U, HELP U, or 
c-HELP U. 

c-sh-U Undoes the last change to the buffer without querying; repeating 

the command several times undoes successive changes in reverse 
order. 

m-K Redo Redoes the previous undo, querying first. 

c-sh-R Redoes previous undo without querying; repeating the command 

redoes successive uses of undo. 

c-Y Yanks back the last thing killed. 

c-sh-Y Yanks back the last killed text matching a string you supply. 

n-Y After a c-Y, yanks back things previously killed; used after a c-Y 

to cycle through the kill ring. After a c-sh-Y, yanks back killed 
text matching the string you supply. 

n-sh-Y After any yank command, prompts for a string and yanks the ele- 

ment, from the appropriate history, that matches the string. 

c-0 c-Y Displays the kill history; click on a line to yank the text back at 

point. 

c-n-Y Repeats the last minibuffer command. 

c-n-sh-Y Repeats the last minibuffer command that matches a string. 

Writing Files 

c-K c-S Writes the current buffer into a new version of the current file 

name. 
c-H c-W Writes the current buffer into a file with a different name. 

m-H Save File Buffers 

Offers to save each file whose buffer has been modified. 
n-H Kill or Save Buffers 

Offers a menu of buffers to Kill or Save. 

Search and Replace 



c-S string "Incremental" search; searches while you are entering the string; 

terminate search with END. 

c-R string "Incremental" backward search; terminate search with END. 

c-7. stringl RETURN string2 RETURN 

Replaces stringl with string2 throughout the buffer. 

r\-Z stringl RETURN string2 RETURN 

Replaces stringl with string2 throughout the buffer, querying for 
each occurrence of stringl; press SPRCE to replace and move to 
next occurrence, RUBOUT to skip and move to next occurrence, or 
HELP to see all options (see HELP C n-Z). Note that RETURN and 
other characters cancel the command. 
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Zmacs Movement and Deletion Commands 

Zmacs offers many commands for moving around and deleting characters, words, 
and other entities. The commands are similar for different entities: For example, 
c-F moves the cursor forward one character and n-F moves it forward one word. 
These commands also take numeric arguments, so you can specify how many units 
to move: For example, c-3-F moves the cursor forward three characters and n-5-F 
moves it forward five words. 

Character Operations 

c-B Moves left (back) a character. 

c-F Moves right (forward) a character. 

RUBOUT Deletes a character left. 

c-D Deletes a character right. 

c-T Transposes the two characters around point; at the end of a line, 

transposes the two characters before point — ht -> th 

Word Operations 

n-B Moves left (back) a word. 

n-F Moves right (forward) a word. 

n-RUBOUT Kills a word left (c-Y yanks it back at point). 

n-D Kills a word right (c-Y yanks it back at point). 

n-T Transposes the two words around point (if only -> only if). 

n-C Capitalizes the word following point. 

n-L Lowercases the word following point. 

n-U Uppercases the word following point. 

Line Operations 

c-R Moves to the beginning of the line. 

c-E Moves to the end of the line. 

c-0 Opens up a line for typing. 

c-K c-0 Closes up any blank lines around point. 

c-P Moves up (previous) a line. 

c-N Moves down (next) a line. 

CLERR-INPUT Kills backward from point to the beginning of the line (c-Y yanks 

it back). 

c-K Kills from point to the end of the line (c-Y yanks it back). 

Sentence Operations 

n-R Moves to the beginning of the sentence. 

n-E Moves to the end of the sentence. 

c-K RUBOUT Kills backward from point to the beginning of the sentence (c-Y 

yanks it back at point). 
m-K Kills from point to the end of the sentence (c-Y yanks it back at 

point). 
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Paragraph Operations 

n- [ Moves to the beginning of the paragraph. 

n-] Moves to the end of the paragraph. 

n-Q Fills the current paragraph (see HELP R Ruto fill). 

c-n c-H F Sets the right margin to n (example: c-6 c-5 c-K F). 



Summary of Zmacs Movement and Deletion Commands 





Forward 


Backward 


Begin 


End 


Delete 
Forward 


Delete 
Backward 


Transpose 


Character 


c-F 


C-B 






C-D 


RUBOUT 


c-T 


Word 


m-F 


m-B 


m-B 


m-F 


m-D 


m-RUBOUT 


m-T 


Lisp Form 


c-m-F 


c-m-B 


c-m-A 


c-m-E 


c-m-K 


c-m- RUBOUT 


c-m-T 


Line 


c-N 


C-P 


c-A 


c-E 


C-K 


CLEAR INPUT 


C-X c-T 


Sentence 


m-E 


m-A 


m-A 


m-E 


m-K 


c-X RUBOUT 





m-v Previous Screen 
c-p Previous Line 



c-b Back Character 
m-B Back Word -« 
c-a Start of Line 



c-f Next Character 
m-F Next Word 
c-e End of Line 



c-n Next Line 
c-v Next Screen 
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Zmail 



Some Basic Zmail Commands 



What the Zmail Menu Commands Do 

These commands let you do almost anything in Zmail. Most of them are also avail- 
able from the keyboard as single-keystroke commands, such as S for [Save]. 

For more information, see the mouse documentation line when you position the 
mouse over a command, or look through the Zmail documentation in "Zmail". 

[Profile] Customizes the Zmail environment. 

[Configure] Changes the Zmail window's appearance. 

[Survey] Displays summary lines of messages in an easily scrollable for- 

mat. 

[Sort] Sorts messages by different criteria, such as Forward by Date. 

[Quit], Q Expunges and saves mail files, then sends you back to the win- 

dow you used prior to Zmail. 

[Save], S Expunges and saves mail files, leaving you in Zmail. 

[Get Inbox], G Reads in your new mail. 

[Map Over] Performs an operation (such as Delete or Hardcopy) on all 

messages in the current mail sequence. 

[Delete], D Deletes the current message and moves to the next one. 

[Next], N Moves to the next message that is not deleted. 

[Jump] Selects a message based on a filter. (Note: This is not equiva- 

lent to J, which moves to a message in the current sequence.) 

[Move], Moves the current message to another sequence. 

[Undelete], U Searches backward for a deleted message, "undeletes" and se- 

lects it. 

[Previous], P Moves to the last previous message that is not deleted. 

[Keywords], L Adds keywords to the current message. 

[Next], N Moves to the next message that is not deleted. 

[Reply], R Starts a reply to the current message. 

[Continue], C, RESUME 

Resumes sending a message. 

[Mail], M Starts a message. 



[Other] 



Repeats the last command given, or gives you a menu of addi- 
tional commands. 
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Getting Help in Zmail 

m-K Describe Command 

Displays detailed help text for a Zmail command you specify, 
similar to HELP D in Zmacs. 

HELP Gives brief help for Zmail single-character commands and 

menu items. HELP * gives brief help for all Zmail extended 
commands. 

n-H Apropos Lists brief help for any Zmail command whose name or first 

line of documentation contains the string you supply; similar to 
HELP R in Zmacs. 



Moving Around in Zmail 

Scrolling the Message Window 

SCROLL, SPRCE, and c-U 

Moves forward one screen in the message. 

n-SCROLL, BRCKSPRCE, and n-U 

Moves back one screen in the message. 

n-> Moves to the last screen of the message. 

n-<, . Moves to the first screen of the message. 

Scrolling the Summary Window 

c-n-U Scrolls the summary window forward. 

c-n-sh-U Scrolls the summary window backward. 

Moving among Messages 

There are many ways you can select a message to read it, reply to it, delete it, 
and so on. 

• Click Left on the message's line in the summary window. 

• Click on [Next] or press N to select the next undeleted message. 

• Click on [Previous] or press P to select the previous undeleted message. 

• Type the number of a message, followed by J, to select a specific message. For 
example, 35J selects message #35. 

• Use the m-K Occur command to get a mouse-sensitive list of lines from mes- 
sages containing a string you supply. 
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Using Sequences 

Your mail messages are grouped in sequences. A sequence is a mail buffer or a col- 
lection you have hand-selected; it's any group of messages you have in a Zmail 
buffer. You can use these sequences in much the same way you use buffers in 
Zmacs. 

c-n-L Selects the mail sequence you most recently used before the 

current one. Numeric arguments (such as c-2 c-n-L) reselect 
the second most recent sequence you used, and so on. 

[Select (R)] Clicking Right on the [Select] menu item gives you a menu of 

sequences from which to choose. 

c-K c-F Reads a mail file you specify into Zmail. If no file with that 

name exists, creates an empty sequence that you can save into 
a mail file with the name you specified. 

c-K c-S Saves the current sequence. If you give it a numeric argument 

(such as c-0 c-K c-S), it expunges the sequence first. 



Some Commonly Used Zmail Commands 

Zmail offers several dozen extended commands. (In Zmail, press HELP, then * in 
response to the prompt, to see a complete list.) Here are a few useful ones; you'll 
undoubtedly add more of your own as you become more familiar with Zmail. 

Commands Available by Clicking Right on a Summary Line 

Zmail provides several different ways of doing things to messages, such as delet- 
ing, forwarding, and hardcopying them. In addition to the menu commands and ex- 
tended commands, you can click Right on a message's line in the summary window 
to get a menu of different actions that can be taken on the message. Here are 
some of the commands available from this menu. 

[Forward] Forwards the current message to recipients you specify. This 

creates a new message and adds text you enter. 

[Redistribute] Resends the current message to recipients you specify. This is 

similar to forwarding, but doesn't create a new message or let 
you add text to the message. 

[Select Conversation] 

Creates a conversation of all messages referenced by the cur- 
rent message, and selects the conversation. This is useful for 
viewing all messages in an exchange. 

[Keywords] Associates keywords with the message. 

[Move] Moves the message to another sequence. 
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Miscellaneous Extended (m-X) Commands 

Note that in Zmail, unlike in Zmacs, you can press just H rather than n-H to enter 
an extended command. Here are a few of the commands that are available. 

n-H Add File References 

Places the pathname to a file in the header of a message. 
When the message is received, the pathname serves as the de- 
fault for Zmail's Compile File, Edit File, Format File, Hardcopy 
File, Load File, and Show File commands. 

n-H Bug Starts a bug report. 

n -K Delete and Save Message 

Deletes the current message and saves its headers and text on 
the kill ring. 

n-H Delete Conversation by References 

Deletes the conversation of all messages referenced by the cur- 
rent message. This is useful when you don't wish to see any of 
the messages in a long exchange. 

i-i-K Describe Command 

Displays the full help text for a Zmail command. 

n-H Edit Current Message, c-R, click Left on message window 

Lets you use all Zmacs commands to edit the current message. 
END saves the edits, RBORT discards them. 

i*i -K Hardcopy Message 

Sends the current message to the default text printer. 

i-i-K Kill Ring Save Message 

Saves the current message's text and headers on the kill ring, 
without deleting the message. 

i*i-H Mark Survey Creates a collection from messages whose summary lines you 
mark. 

n-H Revoke Message 

Either deletes a message you've already sent from the recipi- 
ents' inboxes, or sends a message with a "Revokes" header if 
they have read it. 
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Command Processor 



Some Useful CP Commands 

The following commands are among those available in Lisp Listeners; use the 
Command Processor's Help command to see a complete list of commands. For more 
information on any of the commands: See the section "Dictionary of Command Pro- 
cessor Commands". When you're prompted for keywords, get in the habit of press- 
ing HELP, c-/, or c-? to see what's available; many times, the keywords give you 
interesting options. And move the mouse around output generated by the com- 
mands — part or all of the output can be mouse-sensitive. 

Getting Out of Trouble 

Use the following commands with caution! 



Reset Network 

Initialize Mouse 
Initialize Mail 

Halt Machine 
Boot Machine 



This resets all your existing network connections. If only one 
connection is a problem, use the File System display in Peek 
(SELECT P) to reset it. 

This is useful if your mouse has gotten lost or stuck. 

Use this command only as a last resort when your Zmail is 
hopelessly stuck. 

This command puts you into the FEP, where you can execute 
any FEP command, including Start (to warm boot) and Boot (to 
cold boot). 

This commands boots your machine directly, without going to 
the FEP, using a boot file you specify. It warns you if any files 
are open and asks you to confirm that you want to halt and re- 
boot your machine. 
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Operating on Files 

Copy File 

Create File 

Delete File 
Edit File 

Format File 

Hardcopy File 

Load File 

Rename File 
Show File 



The :Create Directories Yes keyword lets you copy the file into 
a new directory. 

Lets you create a new file or a new version of an existing file 
from a Lisp Listener or a breakpoint. This is particularly use- 
ful when you are using a remote terminal. 

A file you delete from a directory on a Symbolics computer re- 
mains until you expunge the directory. 

Enters the editor and reads in a file you specify. You can spec- 
ify Simple Editor, which uses the input editor and is particu- 
larly useful from remote terminals. 

Processes and displays a file containing Zmacs formatting di- 
rectives. The :Destination keyword sends the output to a sup- 
ported printer. 

Keywords let you specify number of copies to print, whether to 
delete the file after printing, and several other characteristics. 

You can compile a file before loading it with the : Compile key- 
word. 

You can't rename a file to a directory on another host. 

If a file contains any Zmacs formatting directives, use Format 
File. 



Operating on Directories 

Create Directory This creates subdirectories as well as top-level directories. 



Edit Directory 



The :Version keyword lets you specify the files you want to 
edit. 



Expunge Directory This removes deleted files. Remember, files don't really go 
away until they're expunged. 

Show Directory You can click s-sh-Middle on the command's output to change 
the way the files are listed. 



Show FEP Directory 



The keywords let you specify, among other things, a machine 
name, the type of files to display, and whether and how to 
highlight files in use. 
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Operating on the Output History 

Clear Output History 

This defaults to the current window's history, but you can 
specify any dynamic window's history. 

Copy Output History 

You can copy a window's output to any buffer, file, printer, 
stream, or window. 

Show Output History 

You can show the history of any dynamic window at any loca- 
tion available through the :Output Destination keyword. 

Using Software Systems 

Distribute Systems Once you've created a software system, you use this command 
to put it on tape for distribution. 

Load System If you load the same system(s) every time you boot, put a 

(load-system) form in your init file. 

Load Patches This displays patch comments while it loads the patches; to 

turn off the display, specify :Show No. 

Report Bug This is the same as m-K Bug in Zmacs and Zmail. 

Show System Modifications 

Keywords let you identify patches made by particular authors 
on particular dates, and so on. 



Other Useful CP Commands 

The following commands are also available in Lisp Listeners; use the Command 
Processor's Help command to see a complete list of commands. For more informa- 
tion on any of the commands: See the section "Dictionary of Command Processor 
Commands". When you're prompted for keywords, get in the habit of pressing HELP 
or c-? to see what's available; many times, the keywords give you interesting op- 
tions. And move the mouse around output generated by the commands — part or 
all of the output can be mouse-sensitive. 
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Looking at Lisp 

Find Symbol Keywords let you tailor the packages that are searched. 

Set Lisp Context The default context is Common-Lisp. 

Show Expanded Lisp Code 

Try expanding (defmacro form ()()). 

Show Object The :Type keyword lets you specify the type of object to look 

for. 

Show Source Code This works only when the code is currently in an editor buffer. 
Getting Hardcopy 

Hardcopy File Keywords let you specify number of copies to print, whether to 

delete the file after printing, and several other characteristics. 

Show Printer Status 

The output is mouse-sensitive, and can be used as input to the 
Delete Printer Request command. 

Delete Printer Request 

Give it a request by clicking on the one of the requests dis- 
played by the Show Printer Status command. 

Set Printer This doesn't do anything to the printer itself, but specifies 

which printer should handle your text and/or bitmap hardcopy 
requests. 

Controlling Your Environment 

Set Command Processor 

This lets you change the Command Processor's mode and 
prompt, and say whether or not you want commands to prompt. 

Show Command Processor Status 

This tells you what the current mode and prompts are. 

Set Time This sets the local time on your machine. 

Start GC The keywords : Immediately By- Area and : Cleanup Ask do inter- 

esting things. 

Show GC Status Check the output to see if you need to garbage collect. 
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Getting a World 

Copy Flod Files 

Copy Microcode 
Copy World 



On 3600-family machines, flod files are EPROM overlay files 
used by the FEP; on Ivory-based machines, these files are resi- 
dent in the software. 

The world you run on your machine must have the correct mi- 
crocode. 

If your site doesn't support netbooting, you might need this 
command to copy new Lisp worlds. (Netbooting is not support- 
ed on Ivory-based machines.) 



Other Useful Commands 

Edit Namespace Object 

Try editing the object USER your-user-name. 

Expunge Directory This removes all deleted files from the directory you specify. 



Help 

Login 

Select Activity 

Show Differences 

Scan Mail 



The :Format Detailed keyword gives you every available com- 
mand. 

Logging in allows you to run customizations in your init file. 

This duplicates the action of the SELECT key. 

Using this command is like doing m-K Source Compare in 
Zmacs. Check the :Ignore keyword for interesting options. 

This lets you view messages from an inbox one at a time with- 
out entering Zmail. 



Show Documentation 

When you use this command at a Lisp Listener, a bookmark 
for the topic you display is placed in Document Examiner's 
Background Viewer. 

Show Hosts If you don't name specific machines, you get information on all 

machines on the Chaosnet to which your machine is attached. 

Ending a Session 

Save File Buffers By default, it queries about each buffer to be saved. 

Save Mail Buffers With the :Expunge keyword, you can specify whether or not to 
expunge each buffer before saving it. 



Logout 



This command always asks you about saving file and mail 
buffers. 
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Customizing Your Environment 

When you load a file or set a variable (for example, specifying that your hard- 
copies are sent to a certain printer, changing the character style of the screen 
display, or changing the appearance of the command prompt), you alter the default 
system behavior in your environment for the rest of the time you remain logged 
in. This type of per-session customization does not remain in effect in your ma- 
chine after you log out or cold boot. If you load a file or set a variable for an in- 
tentionally temporary effect, this is fine. 

However, if you decide that you want these changes to be put into effect every 
time you log in (permanently in your environment), you can save them in an init 
file, thereby instructing the system to automatically execute this sequence of com- 
mands every time you log in. 

An init file is typically named 1 ispm-init.l isp, and lives in your home directory. 

The following functions are often used in init files. For more information on each 
function, see its documentation. 

tvrset-screen-options &rest vars-and-vals &key (.screen tvrmain-screen) &allow- 
other-keys 
Allows you to set the screen options under program control. 

si:*kbd-repeat-key-enabled-p* 

Controls whether or not the REPERT key is enabled. 

si:*kbd-repetition-interval* 

Controls the speed of repetition of characters when the REPERT 
key is held down. 

si:*kbd-auto-repeat-enabled-p* 

Controls whether or not keys repeat if held down (auto-repeat). 

si:set-auto-repeat-p key &optional (state t) (console sys:*console*) 

Allows you to specify keys that should not auto-repeat even if 
auto-repeat is enabled. 

si:*kbd-auto-repeat-initial-delay* 

Controls how long you must hold down a key before auto- 
repetition starts. 

tv: screen-brightness basic-screen 

Returns the brightness of the screen as a floating-point num- 
ber between and 1. 

tv:*dim-screen-after-n-minutes-idle* 

Controls the length of time a console must be idle before its 
screen dims. 

tv:*screen-dimness-percent* 

Controls the brightness value of the screen when it is dimmed. 

sysrconsole-volume &optional (console sys:*console*) 

Returns the current volume setting for the console. 
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si:*disable-noise-strings* 

Controls whether the Command Processor prints prompts with- 
in command lines. 

zwei:*history-menu-length* 

The maximum number of history elements displayed. 

hardcopy:set-default-text-printer device 

Specifies the printer to be used for all of the hardcopy com- 
mands except the screen copy command. 

hardcopyrset-default-bitmap-printer device 

Specifies the printer to be used for screen copies (by the FUNC- 
TION Q command). 

zwei:*revert-unedited-buffers-for-new-versions* 

Controls the prompting behavior of Refind File, Refind All 
Files, and Revert Buffer if a newer version of the buffer file 
exists on disk. 



Debugger 



Debugger Commands for Displaying Information 

The Debugger commands below help you examine stack frames and analyze the in- 
formation you receive. 

Note that most Debugger commands have one or more corresponding key-binding 
accelerators, which means you can press a combination of one or more keys in 
place of the command. For example, you can type the accelerator c-n-Z instead of 
the command Analyze Frame. In the list below, the accelerator for each command, 
if any, follows the command's name. 

For more information on the Debugger, see the section "Debugger". For a complete 
list of Debugger commands, press c-HELP in the Debugger or see the section "Us- 
ing the Debugger". Also, see the section "Summary of Debugger Commands". 
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Commands for Viewing a Stack Frame 

:Show Argument (c-n-R) 

Displays the value of one or all arguments in the current 
frame. 

:Show Frame (REFRESH, c-L, n-L) 

Redisplays the error message for the current frame, then lists 
the name of the function and its arguments in the current 
frame. 

:Show Local (c-m-L) 

Displays the value of one or all local variables for the function 
in the current frame. 

:Show Compiled Code (c-K D) 

Displays the disassembled code for a function. 

:Show Source Code (c-K c-D) 

Displays the source code for a function. This command works 
only when your code resides in an editor buffer. 

Commands for General Information Display 

Analyze Frame (c-n-Z) 

Analyzes the erroneous frame and locates the source code of 
the current error. 

:Describe Last (c-n-D) 

Executes the Lisp describe function on the most recently dis- 
played value and leaves * set to that value. 

:Show Backtrace (c-B, n-B, c-n-B) 

Displays the control stack, which keeps a record of all active 
functions (those that have been called but have not yet re- 
turned). 

:Show Special Displays the special-variable binding of a symbol in the context 

of the current frame's environment. 



Debugger Commands for Stack Motion and Continuing Execution 

The Debugger commands below help you move around in the stack, restart execu- 
tion, and edit a function. 

Note that most Debugger commands have one or more corresponding key-binding 
accelerators, which means you can press a combination of one or more keys in 
place of the command. For example, you can type the accelerator c-E instead of 
the command :Edit Function. In the list below, the accelerator for each command, 
if any, follows the command's name. 
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For more information on the Debugger, see the section "Debugger". For a complete 
list of Debugger commands, press c-HELP in the Debugger or see the section "Us- 
ing the Debugger". Also, see the section "Summary of Debugger Commands". 

Commands for Moving Through the Stack 

:Bottom Of Stack (n->) 

Moves to the bottom of the stack, displays the least recent 
frame, and makes that frame current. 

:Next Frame (LINE, c-N, n-N, c-n-N) 

Moves down one frame, to the next less-recent frame — the 
calling frame — displays information about that frame, and 
makes it current. 

:Previous Frame (RETURN, c-P, n-P, c-n-P, c-n-U) 

Moves up one frame, to the next most-recent frame — the 
frame that the current frame called — displays information 
about that frame, and makes it current. 

:Set Current Frame (click Left on a frame) 

Makes the frame you click on the current frame. 

:Top Of Stack (n-<)Moves to the top of the stack — the frame where the error oc- 
curred — displays the most recent frame, and makes it cur- 
rent. 

Commands to Continue Execution 

:Abort (RBORT, c-Z) Depending on the context of its use: Returns to top level, re- 
turns to the previously invoked Debugger, or executes the 
restart-handler instruction that appears in the list of proceed 
and restart options. 

:Proceed (RESUME) Depending on the context of its use: Continues the execution of 
the program or process that has been suspended, executes the 
proceed-handler instruction that appears in the list of proceed 
and restart options, or returns to the previously invoked De- 
bugger. 

:Reinvoke (c-n-R) Restarts execution of the function in the current frame. 

:Return (c-R) Returns from the current frame. 

Command to Enter Another Activity 

:Edit Function (c-E) 

Enters the Zmacs editor to bring up the current function or 
any other function for editing. 
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Help Facilities 

Getting Out of Trouble 
Command Processor Commands 

You can use several Command Processor commands to get out of trouble: 

Initialize Mail Reloads Zmail; use only when Zmail is hopelessly stuck. 

Initialize Mouse Restarts the mouse process; use when your mouse does not re- 
spond. 

Reset Network Resets all network connections to your machine; use when your 

machine cannot communicate with any other machines on your 
network. 

Getting Unstuck 

If your machine or a process becomes wedged to the point that it seems frozen, try 
pressing FUNCTION, then hold down CONTROL and press CLERR-INPUT. Usually, this 
will unwedge you. 

If all else fails, you can stop Lisp and go to the FEP by using the CP command 
Halt Machine. (On a Maclvory, you can use the Transfer to FEP choice on the 
Ivory pull-down menu.) If you can't get a Lisp Listener to respond, you can press 
h-c-FUNCTION. (Note that on the UX-family machine, you can use h-c-FUNCTION 
only at the cold load window, not at the Genera console.) 

Note: You should do this only under drastic circumstances. Once you're in the 
FEP, you can type the FEP command Start to warm boot, if you think you left 
your world in a salvageable state; or, you can type the command Boot to cold boot 
your machine. For more information, see the section "Recovering From Errors and 
Stuck States". 
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Other Recovery Procedures 

Sometimes the status line displays a process state that indicates a problem. Some 
of these problems can be solved as follows. 

Server Unit Lock Use SELECT P to go into Peek, then press F for File System. 
Click on the access path to the host, then on [Reset]. 

Wait Forever Select a different window, then reselect the one you were in. 

Output Hold Press FUNCTION ESCRPE; if that puts you in the Debugger, use 

RBORT. 

Sheet Lock Same as for Output Hold. 

Arrest Press FUNCTION - R (that is, a three-key sequence). 

Lock Try FUNCTION O S to see if any windows want to type out. If 

that does not help, press c-RBORT. 

Selected Press FUNCTION O S. 

(no window) Use the mouse or SELECT key to select the window you want. 

You can press SUSPEND to get to a Lisp read-eval-print loop. You can press 
c-n-SUSPEND to force the current process into the Debugger. 
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The SYMBOL Key 

Printing Special Characters with the symbol Key 



You can generate special characters (primarily mathematical symbols) by pressing 
the SYMBOL key in combination with other keys. Here is the complete list of SYMBOL 
key combinations; you can look at this list online at any time by pressing 

SYMBOL-HELP. 



■ 


Center-Dot 


Synbo 


-' 


a 


Alpha 


Synbo 


-R 


« 


Rnd-si gn 


Synbo 


-q 


e 


Ep5"i 1 on 


Synbo 


-E 


>> 


Lambda 


Synbo 


-L 


£ 


Delta 


Synbo 


-D 


± 


PI us-Mi nus 


Synbo 


-: 


00 


Infinity 


Synbo 


-i 


c 


Left-Horseshoe 


Synbo 


-t 


n 


Up-Horseshoe 


Synbo 


-e 


y 


Uni versa 1 -Quant i f i er 


Synbo 


-u 


® 


Circle-^ 


Synbo 


-* 


e- 


Lef t-flrrou 


Synbo 


"J 


* 


Mot-Equal s 


Synbo 


-Equal -si gn 


< 


Less-Or-Equal 


Synbo 


-j 


= 


Equi ual ence 


Synbo 


- ' 


I 


Integral 


Synbo 


-/ 


4. 


Doun-Rrrou 


Synbo 


-h 


P 


Beta 


Synbo 


-B 


-i 


Mot-si gn 


Synbo 


-Mi nus-si gn 


TT 


Pi 


Synbo 


-P 


B 


Ganna 


Synbo 


-G 


t 


Up-Rrrou 


Synbo 


~9 


« 


Circle-Plus 


Synbo 


-PI us-si gn 


a 


Partial-Delta 


Synbo 


-P 


Zi 


Ri ght-Horseshoe 


Synbo 


-y 


u 


Doun-Horseshoe 


Synbo 


-r 


3 


E^i stent i al-Quantifier 


Synbo 


-o 


t 


Doubl e-flrrou 


Synbo 


-1 


■+ 


Ri ght-Rrrou 


Synbo 


-k 


■> 


Lozenge 


Synbo 


-Escape 


I 


Greater-Or-Equal 


Synbo 


-. 


v 


Or-si gn 


Synbo 


-u 
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Other symbol-help Information 

The SYMBOL-HELP display includes the following information about keys that per- 
form special functions: 



RBORT 

c-RBORT 

n-RBORT 

c-n-RBORT 

FUNCTION 

SELECT 

REFRESH 

CLERR-INPUT 

NETWORK 

ESCRPE 

COMPLETE 

c-n-FUNCTION 

SUSPEND 

c-SUSPEND 

n-SUSPEND 

c-n-SUSPEND 

RESUME 

RETURN 

LINE 

END 

HELP 

SYMBOL-HELP 

SCROLL 

n-SCROLL 

h-c-FUNCTION 

LOCRL-G 

LOCRL-n LOCRL-C 
LOCRL-D 



Throws to command level. 

Throws to command level immediately. 

Throws out of all levels. 

Throws out of all levels immediately. 

Performs asynchronous commands. 

Selects a program. 

Refreshes the screen. 

Erases typein. 

Provides commands for Terminal program. 

Shows Input Editor history commands. 

Completes partial input. 

Runs keyboard macros (editor). 

Gets to a read-eval-print loop. 

Suspends immediately. 

Gets to the Debugger. 

Gets to the Debugger immediately. 

Continues from a break or error. 

Inserts a carriage return. 

Goes to the next line and indent (editor). 

Terminates input. 

Prints information about the current context. 

Displays help for the SYMBOL and special-function keys. 

Scrolls forward by screens. 

Scrolls backward by screens. 

Stops the machine and connects you to the FEP. (On the UX 
machine, this works only at the cold load window, not the Gen- 
era console.) 

Rings the bell (press the LOCRL and G keys simultaneously). 

(Where n is a digit from 1 to 4) changes the contrast. 

Makes the screen dimmer. LOCRL-B makes it brighter. 
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LOCRL-D 



Makes the audio quieter. LOCRL-L makes it louder. 



Note that LOCRL key combinations do not work on the UX-family or Mac Ivory ma- 
chine. 

The SDURRE, CIRCLE, TRIRNGLE, and HYPER keys are reserved for user customiza- 
tions. 



The SELECT Key 

You can select an activity (such as Zmail, a Lisp Listener, or Document Examiner) 
by first pressing the SELECT key, then another key, as shown below. 



SELECT = 

SELECT ?. 

SELECT C 

SELECT D 

SELECT E 

SELECT F 

SELECT I 

SELECT L 

SELECT l"l 

SELECT N 

SELECT P 

SELECT D 

SELECT T 

SELECT X 



SELECT Key Selector 

Metering Interface 

Converse 

Document Examiner 

Editor 

File system operations 

Inspector 

Lisp Listener 

Zmail 

Notifications 

Peek 

Frame-Up 

Terminal 

Flavor Examiner 



To create a new activity of the specified type, hold down the CONTROL key while 
typing the letter. For instance, to create a new Lisp Listener, press SELECT c-L. If 
you press SELECT by accident, press RUBOUT. (That is, SELECT RUBOUT does noth- 
ing.) You can also select activities by using the Select Activity command. 
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The FUNCTION Key 

Note: You first press FUNCTION, then one of the keys in the first column below; 
you do not have to hold down FUNCTION while you press the second key. 

The following are some of the more useful FUNCTION key commands; for a com- 
plete listing of FUNCTION key commands, press FUNCTION HELP. 

C Changes the screen from its current state (black-on-white or 

white-on-black) to the other state. 

F Displays a list of users logged in to various machines at a site 

or on a network. FUNCTION O F prompts you for the name of a 
machine and/or a user; see the FUNCTION HELP display to see if 
other numeric arguments (such as FUNCTION 1 F) produce ad- 
ditional listings. 

M Turns **M0RE** processing for all windows on or off, depending 

on the current setting. 



c-M 



c-D 
m-Q 



CLERR-INPUT 
ESCRPE 

RUBOUT 



Turns **M0RE** processing for the selected window on or off, 
depending on the current setting. 

Hardcopies the screen on the default printer. When you pre- 
cede it a numeric argument, you get a menu that allows you to 
change the defaults for hardcopying. 

Hardcopies the current window on the default printer. 

Hardcopies the screen, without the status line, on the default 
printer. 

Selects the window you last used before the current one. For 
example, if you are editing in Zmacs after having sent mail 
from Zmail, pressing FUNCTION S returns you to Zmail. Numer- 
ic arguments (such as FUNCTION 2 S) reselect the second most 
recent window you used, and so on. 

Changes how the current window handles input and output no- 
tifications. See the FUNCTION HELP display for details. 

Discards typeahead. 

Helps correct stuck states such as Output Hold or Sheet Lock; 
these process states show up in the status line at the bottom 
of the screen. 

Does nothing; use it to cancel FUNCTION if you pressed it by 
accident. 
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FEP Commands 

The following are the most commonly used FEP commands. Except where noted, 
each command is available on both 3600-family and Ivory-based machines. 

For a complete description of all FEP commands, see the section "FEP 
Commands". 

Add Paging File FEP Command 

Adds a file to be used for virtual memory swap space during 
the current boot session. On 3600-family machines, the syntax 
is Add Paging-File. 

Boot FEP Command 

Executes the commands specified in a boot file. (On the 
Maclvory, this is automatically done for the user whenever 
Lisp is started). 

Clear Machine FEP Command 

Clears Lisp memory. It is optional on Ivory-based machines. 

Clear Paging Files FEP Command 

Clears the list of paging files added by the Add Paging File 
command. On 3600-family machines, the syntax is Clear Pag- 
ing-Files. 

Clear Screen FEP Command 

On 3600-family machines, clears the console's screen. On Ivory- 
based machines, it clears the Ivory FEP window. 

Continue FEP Command 

Returns you to Lisp from the FEP. 

Debug FEP Command 

Enters you at the FEP Debugger on 3600-family machines or 
the IFEP Debugger on Ivory-based machines. 

Declare More Paging Files FEP Command 

Declares files you specify to be paging files in addition to those 
already declared. On 3600-family machines, the syntax is De- 
clare More Paging-Files. 

Declare Paging Files FEP Command 

Declares files you specify to be paging files. On 3600-family 
machines, the syntax is Declare Paging-Files. 

Enable IDS FEP Command 

Enables the Incremental Disk Save facility. 

Hello FEP Command 

Runs a file of commands, hello.boot, to initialize the machine. 

Initialize Hardware Tables FEP Command 

Initializes the FEP's hardware tables. 
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Load Microcode FEP Command 

Loads microcode from the local disk into the 3600-family ma- 
chine's memory. 

Load World FEP Command 

Loads the Lisp world into the machine, and adds any declared 
paging files. 

Mount FEP Command 

Mounts a specified device. 

Netboot FEP Command 

Loads a netboot core from a local disk into the machine's 
memory. 

Reset FEP FEP Command 

Initializes the FEP's memory. 

Scan FEP Command 

Reads the specified overlay (flod) file. 

Set Boot Options FEP Command 

Sets default values for keywords on the local Ivory-based ma- 
chine. 

Set Chaos Address FEP Command 

Sets the Chaos address of the local 3600-family machine. Ivory- 
based machines must use the Set Network Address FEP com- 
mand. 

Set Default Disk Unit FEP Command 

Sets the disk unit to which Lisp and the FEP should default 
for all subsequent disk references. This command is available 
only on 3600-family machines. 

Set Display-string FEP Command 

Displays a string you specify on the front panel of Symbolics 
machine models 3600, 3640, 3645, 3670, and 3675. 

Set Ethernet Address FEP Command 

Sets the Ethernet address of the local machine. On 3600-family 
machines, the syntax is Set Ethernet-Address. 

Set LMFS FSPT Unit FEP Command 

Sets the default location for the file named f spt . f spt to the 
disk unit specified. 

Set Network Address FEP Command 

Sets the primary network type and address of the local ma- 
chine. On 3600-family machines, the syntax is Set Network- 
Address. 

Set Prompt FEP Command 

Sets the FEP command prompt to a string you specify. 
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Show Directory FEP Command 

Displays the contents of a specified directory in the FEP file 
system. 

Show File FEP Command 

Displays the contents of a file in the FEP file system. 

Show Paging Files FEP Command 

Shows declared and added paging files. On 3600-family ma- 
chines, the syntax is Show Paging-files. 

Shutdown FEP Command 

Halts the FEP and powers down some machine models (query- 
ing appropriately). 

Start FEP Command 

Transfers control to the loaded Lisp world. 
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format Function 



SYNTAX 



BASIC FEATURES 



(format destination control-string arguments) 

destination t prints on the default device (usually the screen), nil doesn't 

print at all, but forces format to return a character string 
containing the output. Otherwise, destination must be a stream. 

control-string A character string that is printed verbatim, except for direc- 

tives that start with " (tilde). 

arguments Displayed in place of the directives; the way the substitution is 

done depends on the specific directive. 

PRINTING DATA 

These directives each consume one argument 



Print any data 

"A as with princ 

"S as with prinl 



Print integers 
"B in binary 
"O in octal 
"D in decimal 
"X in hex 
~nK in radix n 



Print floating-point numbers 
"E in exponential notation 
"F in traditional notation 
"G selects "best" notation 



PRINTING BLANK LINES 

These directives consume no arguments 

~% Print a carriage-return (like terpri) 



'& 



Print a carriage-return only if needed to get to beginning of 
line (like fresh-line) 
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COLUMN WIDTH AND OUTPUT PRECISION 

AUTOMATICALLY INSERTING SPACES UP TO A DESIRED COLUMN WIDTH 

B, "O, D, "X, "R, "E, "F, "G pad on the left 
"A, "S pad on the right 

Put the number of columns right after the tilde. Example: "20D 

Exception! With "R, put the column width after the radix. Example: ~12,20R 

TAB TO DESIRED COLUMN 

~nT Inserts blank space to get out to column number n. Doesn't 

work for files. 

LIMITING PRECISION OF FLOATING-POINT OUTPUT 

"E, "F, and "G can take a second prefix parameter that controls the number of 
digits printed after the decimal point. Example: ~20,4F (This is much like FOR- 
TRAN'S F20.4.) 
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PRINTING NUMBERS IN FANCY FORMATS 

SIGNS AND COMMAS 

"B, "O, "D, and "X allow an optional : and an optional @ just before the letter. 

: (colon) Puts in commas every three digits 

@ (at-sign) Puts in an explicit +-sign if the number is positive 

Examples: "20:D "@0 "35:@B 

SELECTING THE PAD CHARACTER 

"B, "O, "D, and "X usually pad on the left with spaces. You can make them pad 
with any character by supplying a second directive parameter. Example: ~10,'*D 
pads with stars. 

SPELLING OUT CARDINAL AND ORDINAL NUMBERS 

"R (With no radix) prints the argument in English, like thirty- 

four 

Variants: ":R thirty-fourth "@R XXXIV ":@R XXXIIII 

SELECTING SINGULAR AND PLURAL 

~:P Prints an s, but not if the previous argument was 1. Example: 

"Pat R dog:P." 

":@P Like above, but chooses between y and ies. Example: "Pat "R 

pupp":@P." 

CONTROLLING CASE 

~@(...~) Capitalizes the first word of the enclosed text. Example: 

"-@(-R") dog":P" 

Variants: ~:( Thirty-Four ":@( THIRTY-FOUR 
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CONDITIONALS AND SELECTION 

DO SOMETHING ONLY IF A BOOLEAN ARGUMENT IS TRUE 

~@[...~] Uses the enclosure only if the next argument is non-nil. If the 

next argument is nil, it skips the enclosure and discards the 
argument. 

SELECT BETWEEN TWO ACTIONS BASED ON A BOOLEAN ARGUMENT 

":[...";..."] Uses the first enclosure if the argument is nil, and the second 

otherwise. 

SELECT FROM AMONG N ACTIONS BASED ON AN INTEGER ARGUMENT 

"[...";...";..."] Takes an integer argument (starting with 0), and selects the 

enclosure indexed by it. There can be any number of enclo- 
sures. 

"n[... Overrides the argument and selects enclosure n. 

":; If you use this as the last separator, the last enclosure be- 

comes the default. 



loop Syntax 

initially form 

with pattern 1= -fo-rjnj 

repeat number 



for pattern 



|= form fthen formj j 

\J ln N list [by function] { 
|\ 0n / L ) 

Vto ) 

/ below ^ 

\downto / 
above ! 



for identifier |_from numj 



|_by numj 



/until \ tesfc 
^while / 

/collect ^ 
sum I 

. nconc / 

] maximize [ 

\minimize / 

finally form 



form linto identifier] 



